From 1539ade9d5ed5a87693b24b5626fa4c9f28b602b Mon Sep 17 00:00:00 2001 From: Cosimo Cecchi Date: Tue, 7 Jun 2011 12:57:08 -0400 Subject: [PATCH] cssprovider: add a doc paragraph about box-shadow --- gtk/gtkcssprovider.c | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/gtk/gtkcssprovider.c b/gtk/gtkcssprovider.c index 4258b3e776..b25d8e3e0d 100644 --- a/gtk/gtkcssprovider.c +++ b/gtk/gtkcssprovider.c @@ -527,6 +527,32 @@ * which is always rendered on top of the shadow layer. * * + * + * Box shadow + * + * Themes can apply shadows on framed elements using the CSS3 box-shadow syntax, + * as defined in + * the CSS3 specification. + * + * + * A box shadow is specified using the syntax + * box-shadow: [ @inset ] @horizontal_offset @vertical_offset [ @blur_radius ] [ @spread ] @color + * A positive offset will draw a shadow that is offset to the right (down) of the box, + * a negative offset to the left (top). The optional spread parameter defines an additional + * distance to expand the shadow shape in all directions, by the specified radius. + * The optional blur radius parameter is parsed, but it is currently not rendered by + * the GTK+ theming engine. + * The inset parameter defines whether the drop shadow should be rendered inside or outside + * the box canvas. Only inset box-shadows are currently supported by the GTK+ theming engine, + * non-inset elements are currently ignored. + * + * + * To set multiple box-shadows on an element, you can specify a comma-separated list + * of shadow elements in the box-shadow property. Shadows are always rendered + * front-back, i.e. the first shadow specified is on top of the others, so they may + * overlap other boxes or other shadows. + * + * * * Border images * -- 2.30.2